Skip to main content

Get Statement Analysis​

POST https://api.sat.tausi.africa/v2/airtel/1d_analysis

This analyses the pdf and generates the report. The response is in a json format.

Header Requirements​

  • Authorizaion --required

Body Params​

  • file --required
  • fullname --required
curl example request
curl -X 'POST' 'https://api.sat.tausi.africa/v2/airtel/1d_analysis'
 -F fullname=Hussein \ 
 -F 'file=@AirtelMoney_7876543_Statement.pdf' \
 -H 'Authorization: Bearer XXXXXXXXXXX' \

Response Sample​

  1. Status OK Response
200 OK
{
    "initial_info": {
        "owners_number": 255692XXXXXX,
        "start_date": "2023-10-27T00:00:00",
        "end_date": "2023-11-11T00:00:00",
        "total_days": 16,
        "total_active_days": 13
    },
    "profile": {
        "wallet_balance": 0.0,
        "turnover": 169029.0,
        "number_of_transactions": 33
    },
    "cashin_flow": {
        "total_cashin": 84489.0,
        "cashin_flow_turnover_percentage": 49.98,
        "cashin_transactions": 13,
        "cashin_trans_total_trans_perc": 39.39
    },
    "cashout_flow": {
        "total_cashout": 84540.0,
        "cashout_flow_turnover_percentage": 50.02,
        "cashout_transactions": 20,
        "cashout_trans_to_total_trans_percentage": 60.61
    },
    "luku_info": {
        "total_amount_used_to_buy_luku": 0,
        "maximum_amount_used_to_buy_luku": 0,
        "number_of_times_bought_luku": 0,
        "average_amount_bought_luku": 0,
        "last_date_bought_luku": "N/A"
    },
    "bills_info": {
        "total_amount_used_to_pay_bill": 70840.0,
        "maximum_amount_used_to_pay_bill": 26920.0,
        "number_of_times_paid_bill": 15,
        "average_amount_used_to_pay_bill": 4722.666666666667,
        "last_day_paid": "2023-11-11T00:00:00"
    },
    "kamilisha": {
        "total_amount_disbursed": 10489.0,
        "max_amount_disbursed": 5540.0,
        "average_loan_disbursed": 5244.0,
        "last_loan_amount": 5540.0,
        "last_date_borrowed": "2023-11-04T00:00:00",
        "total_amount_repaid": 0,
        "average_amount_repaid": 0,
        "last_date_repaid": "N/A",
        "last_amount_repaid": 0
    },
    "yatosha": {
        "total_amount_paid": 0,
        "max_amount_paid": 0,
        "number_of_times_paid": 0,
        "average_amount_paid": 0,
        "last_day_paid": "N/A",
        "last_amount_paid": 0
    },
    "agent_withdraw": {
        "total_amount_withdrawn_via_agent": 0,
        "maximum_amount_withdrawn_via_agent": 0,
        "number_of_times_withdrawn_via_agent": 0,
        "average_amount_withdrawn": 0,
        "last_time_withdrawn_via_agent": "N/A"
    },
    "p2p_received_info": {
        "total_amount_received_from_peer": 0,
        "maximum_amount_received_from_peer": 0,
        "number_of_times_received_from_peer": 0,
        "average_amount_received": 0,
        "last_time_received_from_peer": 0
    },
    "p2p_sent_info": {
        "total_amount_sent_to_peer": 5620.0,
        "maximum_amount_sent_to_peer": 5620.0,
        "number_of_times_sent_to_peer": 1,
        "average_amount_sent": 5620.0,
        "last_time_sent_to_peer": 5620.0
    }
}

  1. Bad Request Response
400 Bad Request
message: "<The specific error message>"

  1. Unprocessable Entity
422 Unprocessable file entity
message: "Unprocessable File Entity"

  1. Rate Limit Error
429 Rate Limited Error
message: "Rate limited resource",
nexttime:"19876543"

Rate Limiting!

Rate Limited Resource Continous Access will lead to blocking an account.

  1. Internal Server Error
500 Internal Server Error
message: "An Internal Server Error",